home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 4 / Amiga Tools 4.iso / tools / netzwerk / tcp-ip / rdate / rdatetz.readme < prev    next >
Text File  |  1996-02-26  |  3KB  |  92 lines
  1. Author:        Dave.Sparks@sisyphus.demon.co.uk (as at 1 Nov 1995)
  2.  
  3. Requires:   WB 2.04, AmiTCP
  4. Version:    2
  5.  
  6.  
  7. RdateTZ is an alternative to utilities such as SynClock, which set the
  8. local clock in accordance with the time obtained by querying the `daytime'
  9. port (13) of a remote host.  RdateTZ improves on SynClock by:
  10.  
  11.     1    Using the `time' port (37) of the remote host, which returns
  12.     the GMT value of the remote host's clock.  (The `daytime'
  13.     port (13) normally returns the local time at the remote host's
  14.     site, but could return GMT and is not required to identify the
  15.     timezone - see RFC867.)
  16.  
  17.     2    (Optionally) ignoring a remote host whose clock is too far
  18.     out of step with the local clock (reducing the risk of
  19.     synchronising with a clock which is running fast or slow).
  20.  
  21.     3    Using datagrams rather than a stream, which allows several
  22.     remote hosts to be queried simultaneously.  The first
  23.     acceptable (see 2 above) reply is used.
  24.  
  25.     4    Using a file of timezone specifications to set the local clock
  26.     to a specified timezone, allowing for daylight saving time if
  27.     appropriate.  A subset of the XPG3 standard for the TZ
  28.     environment variable is used, which allows the offsets and
  29.     daylight saving time start and end dates of most timezones to
  30.     be encoded.
  31.  
  32.     5    Setting a value identifying the selected timezone in the TZ
  33.     environment variable, and recording an RFC822-compliant
  34.     timezone identifier in the comment associated with the file
  35.     holding this environment variable.
  36.  
  37. SetTZ provides a subset of the RdateTZ interface, which allows the local
  38. clock to be set to a specified timezone without changing the GMT value of
  39. the clock.  This can be called each time the machine is rebooted, or in the
  40. early hours of every morning, to switch to or from daylight saving time on
  41. the appropriate dates.    No attempt is made to access any external host.
  42.  
  43.  
  44. Changes made in version 2:
  45.  
  46.     The configuration file has been updated to reflect changes to
  47.     the daylight saving time dates in Europe and Australia, and to
  48.     add rules for Alaska and Hawaii.
  49.  
  50.  
  51. This distribution consists of the following files:
  52.  
  53.     RdateTZ.readme
  54.  
  55.     This file.  You need not keep it.
  56.  
  57.     RdateTZ
  58.  
  59.     The executable file.  This must be copied to a directory on
  60.     your path (for example c: or amitcp:bin).  The name of the
  61.     copy should be RdateTZ or SetTZ (or both, using MakeLink).
  62.  
  63.     TZ.dat
  64.  
  65.     The file of timezone specifications.  This must be copied
  66.     to s: (the name s:TZ.dat is built in and cannot be changed).
  67.  
  68.     RdateTZ.man
  69.  
  70.     Documentation in AmigaGuide format.  Keep it wherever you like.
  71.  
  72. You *must* set the environment variable TZ before using RdateTZ or SetTZ.
  73. See RdateTZ.man .
  74.  
  75. You may need to modify s:TZ.dat, if your timezone is not included or the
  76. value you need to be given to the TZ environment variable is different from
  77. the value in the issued TZ.dat .  See RdateTZ.man .
  78.  
  79.  
  80. RdateTZ is free software; you can redistribute it provided that:
  81.  
  82.     1    no charge is made for the program
  83.  
  84.     2    all the original files are included intact in the distribution
  85.  
  86.     3    any additional or alternative files are clearly identified as
  87.     such
  88.  
  89. RdateTZ is distributed in the hope that it will be useful, but WITHOUT
  90. ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  91. FITNESS FOR A PARTICULAR PURPOSE.
  92.